home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / patch.arc / PATCH.DOC < prev   
Encoding:
Text File  |  1985-07-01  |  9.9 KB  |  287 lines
  1.  
  2. PATCH - A tool for the IBMPC       (C) 1983 MicroLife
  3.  
  4.     TABLE OF CONTENTS -
  5.                                                             PAGE
  6.  
  7. Introduction................................................  2
  8.  
  9. Equipment required..........................................  2
  10.  
  11. Operation (To edit a file)..................................  3
  12.  
  13. Operation (To edit a disk)..................................  4
  14.  
  15. The Display (What do all of those numbers mean).............  5
  16.  
  17. Function key [F1] (Abort)...................................  6
  18.  
  19. Function key [F4] (Reset)...................................  6
  20.  
  21. Function key [F5] (Exit)....................................  6
  22.  
  23. Function key [F9] (Text/Hexadecimal mode)...................  7
  24.  
  25. Function key [HOME],[Ctrl-HOME].............................  7
  26.  
  27. Function key [END],[Ctrl-END]...............................  7
  28.  
  29. Function key [PgUp],[Ctrl-PgUp].............................  8
  30.  
  31. Function key [PgDn],[Ctrl-PgDn].............................  8
  32.  
  33. Function key [UP-CURSOR]....................................  8
  34.  
  35. Function key [DOWN-CURSOR]..................................  8
  36.  
  37. Function key [LEFT-CURSOR]..................................  8
  38.  
  39. Function key [RIGHT-CURSOR].................................  8
  40.  
  41. Function key [Alt-S] (Select sector for display)............  9
  42.  
  43. BUGS !...................................................... 10
  44.  
  45. INTRODUCTION:
  46.  
  47. PATCH is a utility program for the IBM Personal Computer.
  48. It was written using the  IBM  Macro  Assembler for speed
  49. enhancement.  PATCH  provides  the user  with the ability
  50. to  display and modify any byte  in a disk or  file.  Two
  51. types  of input  are accepted, Hexadecimal characters, or
  52. almost any  key stroke from the keyboard. PATCH's display
  53. is unlike most  other disk  and file  editors, in that it
  54. displays a 256 byte window of  data, and uses  the cursor
  55. keys to position the cursor over the byte to be modified.
  56. The display is split into two parts.  The left portion of
  57. the screen displays the data in  hexadecimal  characters.
  58. The right  portion displays  the character  equivelent of
  59. each byte.  As mentioned earlier, there are two  modes of
  60. input used, hexadecimal  characters or  text  characters.
  61. In the hexadecimal mode, the right  portion of the screen
  62. is used, while in text mode the left portion is used.  In
  63. either mode, the corresponding byte or character  blinks.
  64. Patch can edit single or double sided disks.
  65.  
  66. Since PATCH is a visual editor, it is easier to  use then
  67. it is to describe how to use it. It is highly recommended
  68. that you read  the description of each  function key, and
  69. practice on a scratch disk or file, before using PATCH in
  70. an actual edit.
  71.  
  72. ** NOTE **  Numbers are displayed and used in this manual
  73.             in the following format:  27F(639)
  74.                           Hexadecimal(Decimal)
  75.  
  76. EQUIPMENT REQUIRED:
  77.  
  78. The equipment needed to use this program is:
  79.  
  80. IBM Personal Computer with 48K of memory, and 1 disk drive
  81. 80 Column display capability (color or monochrome)
  82. IBM DOS Version 1.00 or 1.10  (single sided disk supplied)
  83.  
  84. *  IBM is a registered trademark of the International Business
  85.                                          Machines Corporation
  86. OPERATION
  87.  
  88. To edit a file with PATCH the command is:
  89.  
  90.        "PATCH Filename.ext"  or  "PATCH A:Filename.ext"
  91.  
  92. The screen should look as follows:
  93.  
  94. To edit a disk with PATCH the command is:
  95.  
  96.        "PATCH A:" to edit disk in drive A.
  97.  
  98. PATCH will then prompt you to insert the disk to be edited
  99. into the appropriate drive.  To continue, hit any key.
  100. The screen should look as follows:
  101.  
  102. THE DISPLAY - (What do all of those numbers mean)
  103.  
  104.  
  105. To alter a byte or bytes:
  106.  
  107. In Hexadecimal mode:
  108.  
  109. Simply use the cursor keys to position the cursor over the character
  110. to be modified, then enter the new hexadecimal character.
  111.  
  112. In Text mode:
  113.  
  114. Simply use the cursor keys to position the cursor over the character
  115. to be modified, the hit the key of the new character.
  116. Special characters can be entered just by hitting the equivalent
  117. keystroke.  (For a list of characters and their keystroke see the
  118.                       IBM Technical Reference Manual).
  119.  
  120. Function key [F1] - Abort
  121.  
  122. Function key F1 is used to abort PATCH.
  123.  
  124. Aborting PATCH means the currently displayed sector will remain
  125. unchanged and PATCH will return to DOS.
  126.  
  127. ** NOTE **  This does not mean the file or disk will remain
  128.             unchanged, only the sector currently being displayed!
  129.             This means that if you have already changed a byte in
  130.             another sector it will remain changed.  PATCH writes
  131.             modified sectors back to the disk when another sector
  132.             is displayed.
  133.  
  134. Function key [F4] - Reset
  135.  
  136. Function key F4 is used to reset the currently displayed sector.
  137.  
  138. If after changing a byte or bytes on the display you discover an
  139. error, just hit F4 and PATCH will reset the displayed sector to
  140. what it originally was.
  141.  
  142. Function key [F5] - Exit
  143.  
  144. Function key F5 is used to exit PATCH and return to DOS.
  145.  
  146. Hitting F5 will write the currently display sector, if it has been
  147. modified, out to the disk, (close the file if patching a file),
  148. then return to DOS.
  149.  
  150. Function key [F9] - Text/Hexadecimal mode
  151.  
  152. Function key F9 is used to flip the mode back and forth between
  153. Text mode and Hexadecimal mode.  PATCH initially is in the
  154. Hexadecimal mode.
  155.  
  156. Upon hitting F9, the menu on the lower portion of the screen
  157. will be changed to reflect the operation that will occur when
  158. F9 is hit again.
  159.  
  160. Function key [HOME],[Ctrl-HOME]
  161.  
  162. Function key HOME is used to set the display sector to relative
  163. sector 0.
  164. For a file, the first sector in the file.
  165. For a disk, the first sector on the disk.
  166.  
  167. Function key Ctrl-HOME is used when patching a disk.  Its
  168. function depends on the type of disk that is being patched.
  169.  
  170. For single sided disks, the operation is not accepted.
  171.       (You will hear a beep for keys not accepteL⌐ä
  172.  
  173. For double sided disks, hitting Ctrl-HOME sets the display sector
  174. to relative sector 140(320).  This is the first sector on side 2.
  175.  
  176. For files, the operation is not accepted.
  177.  
  178. Function key [END],[Ctrl-END]
  179.  
  180. Function key END is used to set the display sector to the end
  181. of the file or disk.
  182. For a file, it sets the display sector to the last sector in the file
  183. For a disk, it sets the display sector to the last sector on the disk
  184.  
  185.  
  186. Function key Ctrl-END is used when patching a disk. Its operation
  187. depends on the type of disk being patched.
  188.  
  189. For single sided disks, hitting Ctrl-END is not accepted.
  190.  
  191. For double sided disks, hitting Ctrl-END sets the display sector
  192. to relative sector 13F(319). This is the last sector on side 1.
  193.  
  194. For a file, hitting Ctrl-END is not accepted.
  195.  
  196. Function key [PgUp],[Ctrl-PgUp]
  197.  
  198. Function key [PgUp] is used to display the previous 256 bytes.
  199.  
  200. There are two pages for each sector.
  201.  
  202. Page 0 - Bytes 000(000) - 0FF(255)
  203. Page 1 - Bytes 100(256) - 1FF(511)
  204.  
  205. ** NOTE **  Paging across sector boundries will cause modified
  206.             sectors to be written to the disk.
  207.  
  208. Function key Ctrl-PgUp is similar to PgUp, accept paging is
  209. done 16 pages at a time. This command is a medium-fast
  210. method to arrive at the desired sector to be patched.
  211. (See above note).  (For a faster method, see Alt-S).
  212.  
  213. Function key [UP-CURSOR],[DOWN-CURSOR],[LEFT-CURSOR],[RIGHT-CURSOR]
  214.  
  215. The cursor keys are used to position the cursor over the byte or
  216. character, depending on the mode, to be changed.
  217.  
  218. The UP-CURSOR moves the curosr up.
  219. The DOWN-CURSOR moves the cursor down.
  220. The LEFT-CURSOR moves the cursor left.
  221. The RIGHT-CURSOR moves the cursor right.
  222.  
  223. Function key [Alt-S]
  224.  
  225. Function key Alt-S is a fast, direct way to arrive at the desired
  226. sector to be patched.  Input is accepted in either hexadecimal or
  227. decimal.
  228.  
  229. Upon hitting Alt-S, PATCH will prompt you to enter a relative sector
  230. number.  The prompt is as follows:
  231.  
  232. Enter relative sector # [0 => sector# => HEX(DEC)]:
  233.  
  234. The numbers HEX(DEC) show you the maximum sector number PATCH
  235. will accept.
  236. For files, this is the last sector in the file.
  237. For disks, this is the last sector on the disk.
  238.  
  239. To enter a sector number type the sector number as follows:
  240.  
  241. In Decimal: just type the sector number, then hit enter.
  242.  
  243. In Hexadecimal:
  244.  
  245. If the sector number has an alphabetic character (A-F),
  246. just enter the sector number, then hit enter.
  247.  
  248. If the sector number does not have an alphabetic character in it,
  249. just precede the sector number with an H (If you don't include
  250. the H, PATCH will assume the sector number is in decimal).
  251.  
  252. When a wrong entry has been made, and the enter key has not yet
  253. been pressed, there are two editting keys you can use.
  254. The backspace can be used to delete the previous character.
  255. The HOME key can be used to delete the whole entry.
  256.  
  257. If after hitting Alt-S you decide you don't want to enter a
  258. sector number, you can hit escape to continue patching where
  259. you left off.
  260.  
  261. When PATCH has determined your entry is bad, it will display
  262. an error message and beep at you, it will then let you re-enter
  263. the sector number.
  264.  
  265. BUGS !
  266.  
  267. PATCH has been in use for some time now, and hopefully most of
  268. the bugs have been found and resolved.  If you should discover
  269. a bug, we  will  work with  you to resolve  it.  This does not
  270. imply that  you will  automatically receive  updates of  PATCH
  271. as new versions are released.
  272.  
  273. To report a bug:
  274.  
  275. To report a bug, fill out the bug report form at the end
  276. of this manual.  Be sure to  fill in the serial number.
  277.  
  278. Mail the completed form to:    MicroLife
  279.                                PO Box 340
  280.                                Jessup, MD   20794
  281.  
  282.                                Attn: Jerry W. Shipman
  283. *********************************************
  284. This program uploaded by Jerry shipman to   *
  285. Capital PC Software Exchange.               *
  286. This program is not to be sold for profit.  *
  287. *********************************************
  288.